Button Tool - Showing a Label, Point Attributes, or Point State

The object’s [DisplayItem] property determines the point attribute to be displayed. If this property is set to Text, the text listed in the Text property will be displayed. Use this configuration for a label. All other options in the [DisplayItem] property are point attributes. These attributes include point configuration attributes, point CVS record attributes, and facility attributes. The Text property can contain both static and dynamic text. The dynamic portion of the string is built using tokens. The use of the Text property with tokens provides a method for you to include more than one dynamic item. See Using Text Tokens for more information about tokens and formatting token strings.

To show point attributes or point state on the button face, associate the object with a point using the point identifier properties to form a fully qualified CygNet tag string. The point identifier properties are [1:SiteService], [2:Point ID], [3:Long Point ID], [4:Facility ID], and [5:UDC]. If the object is on a templated screen, only use the [5:UDC] property.

If the button is configured to show a Bitmap and a [DisplayItem], the Layout property determines the alignment of the text to the bitmap.

The [AlarmElement] property can be set to show the point state color in the object’s Background Color, the Foreground Color, or not at all (None). When set to None, the color specified for each component is shown. If set to one of the other options, the component color is replaced with the point state color.

The [UseCustomStateColors] property enables the object to use its own custom point state colors. If set to 1 - Yes, the colors used are those defined by the object’s [CustomStateColors] property. If set to 0 - No, the colors are those defined by the TheView’s [CustomStateColors] property.